MPExtractTaskState

MPExtractTaskState
Header:	Multiprocessing.h		Carbon status:	Supported

Extracts state information from a suspended task.

OSStatus MPExtractTaskState (
    MPTaskID task, 
    MPTaskStateKind kind, 
    void *info
);

task: The task whose state information you want to obtain.
kind: The kind of state information you want to obtain. See “Task State Constants” for a listing of possible values.
info: A pointer to a data structure to hold the state information. On return, the data structure holds the desired state information. The format of the data structure varies depending on the state information you want to retrieve. See the header file MachineExceptions.h for the formats of the various state information structures.

function result: A result code. If you attempt to extract state information for a running task, this function returns kMPInsufficientResourcesErr.

DISCUSSION

You can use this function to obtain register contents or exception information about a particular task.

Also see the function MPSetTaskState.

VERSION NOTES

Introduced with Multiprocessing Services 2.0.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when MPLibrary 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by MPLibrary 2.0 and later.